IGroup.Inch method

Commands a never-ending controlled motion at a specified velocity for an axis group with a maximum distance. After the axis reaches the maximum distance it will automatically stop.

Namespace: IntervalZero.KINGSTAR.Base.Class

Assembly: IntervalZero.KINGSTAR.Base.Class (in IntervalZero.KINGSTAR.Base.dll) Version: 4.4.0.0

Syntax

C#VB

IGroupInchCommand Inch(
       double[] distance,
       double[] velocity,
       double acceleration,
       double deceleration,
       double jerk
)

Function Inch(
       distance As Double(),
       velocity As Double(),
       acceleration As Double,
       deceleration As Double,
       jerk As Double
)As IGroupInchCommand

Parameters

distance

Type: double[]

The maximum distance traveled by this move.

velocity

Type: double[]

A value of the specified velocity. [unit/second]

acceleration

Type: double

A value of the acceleration. The unit is determined by the McProfileType type. (increasing energy of the motor) [unit/second²] or [second]

deceleration

Type: double

A value of the deceleration. The unit is determined by the McProfileType type. (decreasing energy of the motor) [unit/second²] or [second]

jerk

Type: double

A value of the jerk. The unit is determined by the McProfileType type. [unit/second³] or [second]

Return value

Type: IGroupInchCommand

Returns a state of a group's inch move.

Remarks

The Velocity, Acceleration, Deceleration and Jerk are for each axis in the group, not for the path values. If one of these parameters' values, for example, Acceleration, exceeds the maximum Acceleration of one of the axes in the group, the axis will use its own max Acceleration value. Other axes use the provided values.
Velocity and Distance can be modified when the axis group is running.

IMPORTANT: If the distance is very short and the velocity is very fast, the "braking distance" for the axis may exceed the distance you specified, which can cause the axis to crash.

The elements of the Distance array must be greater than zero (> 0). That is, the distance for each axis to travel is greater than zero (> 0).
InchGroup can be used only in the GroupStandstill state.
If one of the axes in the group has done the movement and others haven't, but you want to keep that axis moving, you have two choices:
- Increase the distance. The axis will travel the increased part in another movement. For example, you change the distance from 2000 to 2500. The axis will travel 500 units more after it traveled 2000 units.
- Change the velocity of the axis. The axis will travel the current distance again using the new velocity.